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About This Guide 



This Quick Reference Guide is for experienced operators 
and administrators who are already familiar with the 
functions and features of BTOS and BTOS workstations, 
and with the material presented in the BTOS Standard 
Software Operations Guide. 

Therefore, it is assumed that you know how to perform 
basic tasks, such as turning your workstation on and off, 
and signing on and off, etc. 

This guide is divided into two sections: 

a Section 1, Commands, consists of an alphabetical listing 
of the BTOS commands that you enter by either typing 
the command and pressing GO, or typing the command, 
pressing RETURN, and filling in the command form. 

o Section 2, Tables, is a compilation of tables extracted 
from the BTOS Standard Software Operations Guide 
and consolidated for easy access. 

This guide also includes a table of contents and a 
comprehensive index to help you quickly find the 
information you need. 
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Section 1 1-1 

Commands 

Introduction 

This section contains an alphabetical listing of the BTOS 
commands you enter by either typing the command and 
pressing GO, or typing the command, pressing RETURN, 
and filling in the command form. 

Each command listing includes the following: 

a a figure illustrating the command form 

a a description of the entries you must make in the 
command form's mandatory fields 

d a description of the entries you can make in the 
command form's optional fields 



5026339 



1*2 Commands 

Figure Title 

1 APPEND Command Form 

2 BACKUP VOLUME Command Form 

3 BOOTSTRAP Command Form 

4 CHANGE VOLUME NAME Command Form 

5 CLUSTER STATUS Command Form 

6 COMMAND FILE EDITOR Command Form 

7 COPY Command Form 

8 CREATE CONFIGURATION FILE Command Form 

9 CREATE DIRECTORY Command Form 

10 CREATE FILE Command Form 

1 1 CREATE PARTITION Command Form 

12 DEBUG FILE Command Form 

13 DELETE Command Form 

14 DISABLE CLUSTER Command Form 

15 DUMP Command Form 

16 EDIT Command Form 

17 FILES Command Form 

18 FLOPPY COPY Command Form 

19 FORMAT Command Form 

20 INSTALL PROTECTED MODE Command Form 

21 INSTALL SPOOLER Command Form 

22 INSTALL TELEPHONE SERVER Command Form 

23 IVOLUME Command Form 

24 LCOPY Command Form 

25 LIST Command Form 

26 LOGIN Command Form 

27 MAINTAIN FILE Command Form 

28 MAKE TRANSLATION FILE Command Form 

29 MERGE Command Form 

30 NEW COMMAND Command Form 

31 PATH Command Form 

32 PLAYBACK Command Form 

33 PLOG Command Form 

34 PRINT Command Form 

35 RECORD Command Form 

36 REMOVE COMMAND Command Form 

37 REMOVE DIRECTORY Command Form 

38 RENAME Command Form 

39 REPLAY Command Form 

40 RESTORE Command Form 

41 RUN Command Form 

42 RUN FILE Command Form 

43 SCREEN SETUP Command Form 

44 SELECTIVE BACKUP Command Form 

45 SET DIRECTORY PROTECTION Command Form 



Commands 1*3 

46 SET FILE PREFIX Command Form 

47 SET PROTECTION Command Form 

48 SET TIME Command Form 

49 SOFTWARE INSTALLATION Command Form 

50 SORT Command Form 

51 SUBMIT Command Form 

52 TYPE Command Form 

53 USER FILE EDITOR Command Form 

54 VIDEO Command Form 

55 VOLUME STATUS Command Form 

56 WRITE HARDWARE ID Command Form 

57 XESOFTWARE INSTALLATION Command Form 
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APPEND Command 

Figure 1 APPEND Command Form 



| File list frow | 
File to 
[Oonflm each?] 



Mandatory fields: 
File list from 



File to 



Enter the name(s) of the file(s) 
you want to append. You can use 
the wild card character in this field. 

Enter the name of the file in 
which you want the file or list of 
files merged. If this destination 
file does not exist, the system 
creates it. 



Optional field: 
[Confirm each?] 



If you accept the default (no), the 
system does not prompt you for 
confirmation of each file you 
want to append. 

To receive a prompt for 
confirmation of each file, you 
enter y in this field. 
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BACKUP VOLUME Command 

Figure 2 BACKUP VOLUME Command Form 



Backup Volume 


Volume or device name 


[Volume or device password] 

[Incremental from (e.g., Mon. 3 Dec 1984 8:00 pm)] 

[Suppress backup?] 

[Suppress verification?] 

[Archive file] 

[Delete existing archive file?] 

[Log file] 

[Display structures?] 

[Verify write?] 



Mandatory field: 
Volume or device 



name 



Enter the name of the volume or 
device you want to backup. 



Optional fields: 

[Volume or device 
password] 



[Incremental from 
(e.g., Mon 3 Dec 
1984 8:00 pm)] 



The default indicates that no 
password is assigned to the 
volume or device you want to 
backup. 

If the volume or device you want 
to backup has a password, enter 
the password in this field. 

The default directs the system to 
backup all files on the volume or 
device. 

To backup only those files 
modified on or after a specific 
date, enter the beginning date. 
The time is optional. If you do not 
enter a time, the system backs up 
all files modified and/or created 
since 12:00 AM (midnight) of the 
specified day. 
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[Suppress backup?] 



[Suppress 
verification?] 



[Archive file] 



[Delete existing 
archive file?] 



Use the following guidelines when 
making incremental backups: 

o Perform a full backup 

whenever you increase the size 
of a directory. 

a Files that you delete during the 
week are not reflected in an 
incremental backup. 

The default is no; the system 
backs up the files you specified. 

To verify the integrity of the 
volume control structures without 
performing a backup, enter y. 

The default is no; the system 
verifies the integrity of the 
volume control structures. 

To backup the files only, without 
verifying the integrity of the 
volume control structures, enter y. 

The default directs the system to 
create [ArchiveJ<Sys>.nn as the 
default archive file name (nn 
represents a number the system 
supplies). 

To assign a name other than 
Archive to the file which the 
system creates, enter the name in 
this field. 

The default is no. If you accept 
the default and the archive file 
already exists, the system 
displays the following when you 
complete the command form and 
press GO: 

File already exists. Delete? 
(Press GO to confirm, CANCEL 
to deny, or FINISH to return to 
the Executive.) 

To automatically overwrite the 
existing archive file, enter y. 
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[Log file] 



[Display structures?] 



[Verify write?] 



The default directs the system to 
display the log on the screen only. 
To write a report of the BACKUP 
VOLUME operation to a file, enter 
the name of the file you want it 
written in. If the log file already 
exists, the system automatically 
appends the log to it. If it does 
not exist, the system creates it. 

To send the log file directly to a 
printer, enter a device name (for 
example, [Lpt]). 

The default is no; the system does 
not display an analysis of the 
volume control structures. 

To display a detailed analysis of 
the volume control structures, 
enter y. 

The default is no; the system does 
not perform a physical read after 
each write to insure that the 
file(s) you are backing up are the 
same as the previously backed up 
file(s). 

Note: It is probably not necessary to fill in 
the [Verify write?] field if you have verified 
the hard disk or diskette for bad spots using 
the IVARCHIVE command. 

To verify each read and write 
operation for the file(s) that you 
are backing up, enter y. 
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BOOTSTRAP Command 



Figure 3 BOOTSTRAP Command Form 



Bootstrap 

1 File to bootstrap fro* 1 £ 
[Sys volume or vsmm] 



Mandatory field: 

File to bootstrap 
from 



Enter a parameter (for example, 
[Sys]<Sys>SysImage.sys 



Optional field: 

[Sys volume or 

wsNNN] 



Specify a local volume or the 
master volume as the system 
volume. The default is your 
workstation volume and file 
name. 
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CHANGE VOLUME NAME Command 

Figure 4 CHANGE VOLUME NAME Command Form 



Changs Voluw Nan 
|pevlce rem | 

[Device pa ssw o r d] 
[Old values password] 
Nee volun nan 
[Nw voiubb password] 



Mandatory fields: 
Device name 



New volume name 



Enter the name of the device that 
contains the volume whose name 
you want to change. 

Enter the new name (a maximum 
of 12 characters) to assign to this 
volume. If you want to add, 
change, or delete a password only 
for the volume, you enter the 
existing name and then enter 
parameters in the appropriate 
optional fields. 



Optional fields: 
[Device password] 



[Old volume 
password] 



The default indicates to the 
system that no password is 
assigned to the device containing 
the volume you want to change. 

If a password is assigned to the 
device containing the volume you 
want to change, enter the 
password in this field. 

The default indicates to the 
system that no password is 
assigned to the volume you want 
to change. 

If a password is assigned to the 
volume you want to change, enter 
the password in this field. 
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[New volume The default directs the system to 

password] leave the new volume 

unprotected; no password is 
necessary to access it. 

To change or assign a password to 
the volume named in the New 
volume name field, enter the 
word or characters (a maximum 
of 12) you want to use for the 
password. You cannot change or 
assign a password to the volume 
currently in use. 
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CLUSTER STATUS Command 

Figure 5 CLUSTER STATUS Command Form 



Cluster status 



[Line nutter (default « 0)] 



[One tim display?] 



Optional fields: 

[Line number 
(default = 0)] 



[One time display?] 



The default is for a standard 
channel. 

To request status information for 
a communications line other than 
the standard channel, enter the 
line number. 

The default is no; the status 
display remains on the screen and 
is updated every second. 

To request a one-time status 
display, enter y; the status 
display remains on the screen, but 
is not updated. 
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COMMAND FILE EDITOR Command 

Figure 6 COMMAND FILE EDITOR Command Form 



OoMBnd File Editor 

| [cw o na f liej~l [ 



Mandatory field: 

[Command file] Enter the command file you want 

to access. 
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COPY Command 

Figure 7 COPY Command Form 



Copy 


|Fiie fro» • | |;:;:i:;:i:;:i:i:;:;:i:i:;:::::;:;:;:i:;:;:;:i:::i:i:;:;:;:;>:;:;>:;:;:;:;:;:;:;:;:;:;-::::;:;:;:;:;:;:;>-| 


File to 

[Overwrite ok?] 
[conflrn each?] 


Mandatory fields: 
File from 


Enter the name of the file you 
want to copy. 



File to 



Optional fields: 
[Overwrite ok?] 



Enter the name of the file to 
receive the copy of the file you 
named in the File from field. If 
the file does not exist, the system 
creates it. 



If you accept the default and a 
file named in the File to field 
already exists, the system 
displays the following 
confirmation message when you 
complete the command form and 
press GO: 

File (File name) already exists. 
Overwrite? (Press GO to 
confirm, CANCEL to deny, or 
FINISH to stop command.) 

If you enter n, the system does 
not perform an overwrite 
operation. 

To overwrite an existing File to 
field file, enter y. The system 
deletes the contents of the 
existing file and continues the 
copy operation. 
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[Confirm each?] The default is no; the system doSs 

not prompt you to confirm each 
copy operation. 

To receive prompts to confirm 
each copy operation, enter y. 
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CREATE CONFIGURATION FILE Command 



Figure 8 CREATE CONFIGURATION FILE Command Form 



Create Configuration File 



Configuration file name 



Device type (conn parallel lpt, or serial ptr) 



Mandatory fields: 

Configuration 
file name 



Device type (comm, 
parallel lpt, or 
serial ptr) 



Enter a new configuration file 
name to create a new file, or enter 
the name of an existing 
configuration file you want to 
modify. 

Specify the type of device you 
want to configure: 

d Enter the letter c for a 
communications device. 



o Enter the letter p for a parallel 
printer (direct or spooled). 

a Enter the ietter s for a serial 
printer (direct or spooled). 
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CREATE DIRECTORY Command 

Figure 9 CREATE DIRECTORY Command Form 



Create Directory 



New Directory name(s) 



[Protection level (default - 15)] 
[Maximum number of files (default - 75)] 
[Password for new directory] 
[Volume password] 



Mandatory field: 

New directory 
name(s) 



Enter a name for the new 
directory you want to create. 



Optional fields: 

[Protection level 
(default = 15)] 



[Maximum number of 
files (default = 75)] 



[Password for 
new directory] 



The default assigns an 
unprotected (15) protection level 
to all files in the directory(ies). 

To assign a modify protected (5) 
or an access protected (0) 
protection level to the files in a 
directory, enter the appropriate 
number. 

The default sets the maximum 
number of files for each directory 
at 75. To set the maximum file 
limits for the directory to a larger 
or smaller number, enter the 
number. 

The default leaves the new 
directory(ies) unprotected; no 
password is necessary to access it. 

To assign a password to the 
directory, enter the word or 
characters (a maximum of 12) you 
want to use for the password. 
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[Volume password] The default indicates that a 

password is not assigned to the 
volume. 

If the volume has an assigned 
password, you must enter the 
password to gain access to the 
volume. 
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CREATE FILE Command 

Figure 10 CREATE FILE Command Form 



Create File 



File i 



[Voltpe or Directory pessmrd] 
[File password) 

(File protection level (default ■ IS)} 
(Size in sectors (default ■ 0)] 
(Overwlte ox?] 



Mandatory field: 
File name 



Enter the name you want to 
assign to the new file. 



Optional fields: 

[Volume or directory 
password] 



[File password] 



[File protection 
level (default = 15)] 



The default indicates to the 
system that no password is 
assigned to the volume or 
directory of the new file. 

If a password is assigned to the 
volume or directory of the new 
file, enter the password in this 
field. 

The default leaves the new file 
unprotected; a password is not 
necessary to access it. 

To assign a password to the new 
file, enter the word or characters 
(a maximum of 12) you want to 
use for a password. 

The default sets the protection 
level for the file at unprotected 
(15). 

To set the protection for the file 
at a level other than unprotected, 
enter the protection decimal 
value. 
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[Size in sectors 
(default = 0)] 



[Overwrite ok?] 



The default sets the file length 
to sectors. 

To set a size for this file other 
than sectors, enter the number 
of sectors you want to assign to it. 

If a file with the name you 
entered in the File name field 
already exists, the default directs 
the system to prompt you for 
confirmation before overwriting 
the file's contents. 

To overwrite the contents of an 
existing file with the same name 
as you entered in the File name 
field, enter y. 

If a file with the same name as 
you entered in the File name field 
exists and you do not want to 
overwrite its contents, enter n. 
The system cancels the CREATE 
FILE command. 
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CREATE PARTITION Command 

Figure 1 1 CREATE PARTITION Command Form 



Create Partition 



| [hawory Size (default ■ 200K)] | 
[Partition naae (default • Bacfcgroundoo)] 



Optional fields: 

[Memory size 
(default = 200K)] 



[Partition name 
(default = 
Background 00)] 



The default sets the partition 
memory size at 200KB. 

To specify the memory size of the 
partition, enter the size in 
K bytes. The partition requires 
1.5KB to store system data 
structures associated with it; 
include this amount in your total 
memory size. 

The default names the partition 
Backgroundnn, where nn begins 
with 00. If you create more than 
one secondary application 
partition with a default partition 
name, the system names the first 
partition BackgroundOO, the 
second partition BackgroundOl, 
etc. 

To specify a name for the 
partition, enter the name. 



Commands 



1-21 



DEBUG FILE Command 

Figure 12 DEBUG FILE Command Form 



O eoug Fixe 
| File nawe | 
[•rite?] 
(Inge wde?] 



Mandatory field: 
File name 



Enter the run file name. 



Optional fields: 
[Write?] 



[Image mode?] 



The default (no) does not allow 
you to modify the file. 

To allow file changes, enter y. 

The default is no. The system 
interprets the file as it appears 
when BTOS loads it into memory. 

To direct the system to interpret 
the data as it appears in the run 
file, enter y. 
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DELETE Command 

Figure 13 DELETE Command Form 



Delete 



| File list 



[Conf lr» eacn?] 



Mandatory field: 
File list 



Enter the name of the file you 
want to delete. 



Optional field: 
[Confirm each?] 



The default for this field is no; 
the system does not prompt you 
to confirm each file you want to 
delete. If you want to confirm 
each file before the system deletes 
it, enter y. 
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DISABLE CLUSTER Command 

Figure 14 DISABLE CLUSTER Command Form 



Disable Cluster 



[Tire Interval (seconds)] 



Optional field: 

[Time interval Specify the number of seconds 

(seconds)] you want the system to wait 

before disabling the cluster. 

The default is 0. 
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DUMP Command 

Figure 15 DUMP Command Form 



Dump 



[ Input file 



[Conpare file] 
[Output file] 
[File address first] 
[File aooress limit] 
[Continue on differences?] 



Mandatory field: 
Input file 



Enter a file name (for example, 
(Sys]<Acctg>Month). 



Optional fields: 
[Compare file] 



[Output file] 



The default is no comparison; the 
system displays only the input file. 

To compare the input file with 
another file, enter the other file 
name. The system limits the 
display to the file addresses range 
specified in the [File address 
first] and [File address limit] 
fields. 

At the end of the comparison, the 
system displays either the 
message, Differences 
encountered, or the message, No 
differences encountered. 

The default directs the system to 
only display the comparison; the 
comparison is not saved. 

To write the comparison to a file, 
enter the file name. If the file 
exists, the system discards the 
contents of this file and saves the 
comparison in it. If the output file 
does not exist, the system creates it. 
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[File address 
first] 



[File address 
limit] 



The default (0) directs the 
system to display a comparison 
starting at the beginning of the file. 

To specify a beginning file 
address for the display or 
comparison, enter the 
hexadecimal number of the file 
address. The final h of the 
hexadecimal number is 
unnecessary. 

The default is the file end. 

To specify an ending file address 
for the display or comparison, 
enter the hexadecimal number of 
the file address. If the value you 
enter is greater than the end of 
the file, the limit is the end of the 
file. 



[Continue on 
differences?] 



The default is no. When you use 
the DUMP command in a submit 
file, the system halts the submit 
execution. 

To continue execution if the 
system finds differences while 
executing a submit file, enter y. 



5026339 



1-26 



Commands 



EDIT Command 

Figure 16 EDIT Command Form 



Edit 



File 



[Your rare] 



Mandatory field: 
File 



Enter the name of a file you want 
to edit. 



Optional field: 
[Your name] 



The default is xxxx.ts where 
xxxx is the logged-on user name. 
If you want to use a prefix for 
the .ts file other than the logged- 
on user name, you enter the name 
in this field. If there is no logged- 
on user and you leave this field 
blank, the default is .ts. 
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FILES Command 

Figure 17 FILES Command Form 



Files 



[File list] 
[fetalis?] 
[Print file] 



Optional fields: 
[File list] 



[Details?] 



[Print file] 



The default is the asterisk wild 
card character. It directs the 
system to display the file names 
in the directory of the current path. 

To display information about 
specific files or files in a 
directory other than that of the 
current path, enter the file 
name(s) or complete file 
specification. You can use the 
wild card character in this field. 

The default (no) directs the 
system to display the file name(s) 
only. 

To display details about the 
file(s), enter y. 

If you accept the default, the 
system does not store or print the 
FILES information; it appears on 
the screen only. 

To store the information in a file 
from which you can later display 
or print the information, enter a 
file name for the storage file. 

To send the information directly 
to a device such as a printer, 
enter an appropriate device name 
(for example, [Lpt]). 
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FLOPPY COPY Command 

Figure 18 FLOPPY COPY Command Form 



Floppy Copy 


[Number of copies] 


[Overwrite OK?] 
[Dual floppy?] 
[Supppress verify?] 
[Device name(s)] 
[Volume 1 password] 
[Volume 2 password] 



Optional fields: 
[Number of copies] 



[Overwrite ok?] 



[Dual floppy?] 



The default is unlimited copies. 
To specify the number of copies 
you want to make from each 
master diskette, enter the number. 

If you accept the default (no 
entry) or enter n, the system 
prompts you to overwrite any 
existing data on the diskette used 
for the copy. 

To overwrite existing data on the 
diskette used for the copy, enter y. 

The default is no for workstations 
with a single floppy disk drive. 

If your workstation has dual 
floppy disk drives and one or 
more hard disk drives, enter y. 
The system makes the copy with 
the master diskette in floppy disk 
drive [fO] and the duplicate 
diskette in [fl]. 
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[Suppress verify?] 



[Device name(s)] 



The default (no) directs the 
system to reread the information 
on the diskettes and to verify it is 
correct. 

If you do not want the system to 
reread the master and duplicate 
diskettes to verify no errors 
occurred during the copy 
operation, enter y. 

The default is [fO] (lefthand drive) 
[fl] (right hand drive). You accept 
this value unless you have a 
customized operating system with 
different disk drive names. 

If you have a customized 
operating system with disk drive 
names other than [fO] (lefthand 
drive) and [fl] (righthand drive), 
enter the device names in this field. 



[Volume 1 password] 



[Volume 2 password] 



The default indicates that the 
source diskette from which you 
are copying does not have a 
password. 

If you want to password protect 
your source diskette, enter a 
password in this field. 

The default indicates that the 
destination diskette will not be 
password-protected . 

If you want to password protect 
your destination diskette, enter a 
password in this field. 
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FORMAT Command 

Figure 19 FORMAT Command Form 



Forest 



File list 



[Print to] 

[Conflra each?) 

[Title] 

[First page to forat] 

[Last page to forest] 

[Suppress page nutters?] 

[Suppress date?] 

[Suppress tine?] 

[Double-space?] 

[Left eargin (default 10 spaces)] 

[Text width (default 65 spaces)] 

(Page length (default 66 lines)] 

[Top eargin (default 6 lines)] 

[Sottas Hergln (default 6 lines)] 

[Tab vldth (defeult 8 spaces)] 

[Suppress pege ejects between files?] 



Mandatory field: 
File list 



Enter the file specification, file 
list, or at-file name for the file 
you want to format. 



Optional fields: 
[Print to] 



The default directs the system to 
print the formatted file on the 
spooled printer [Spl]. 

To direct the printing to a printer 
other than the spooled printer 
enter one of the following: 

d the device name of a local 
printer for direct printing 

d the name of a Scheduling queue 

a the name of the file in which 
you want the system to write 
the formatted image of the 
input file. Do not enclose this 
name in brackets. 
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[Confirm each?] 



[Title] 



[First page to 
format] 



[Last page to format] 



[Suppress page 
numbers?] 



[Suppress date?] 



[Suppress time?] 



The default is no; the system does 
not prompt you for confirmation 
before formatting the file. 

To receive confirmation prompts 
before the system formats each 
file, enter y. 

The default directs the system to 
print the file name as the title. 

To specify a title for the top of 
each page of the file, enter the title. 

The default is page one of the 
file. 

To specify the first page you 
want formatted, enter the number 
of the page. 

The default is the last page of the 
file. 

To specify the last page you want 
formatted, enter the number of 
the page. 

The default is no; the system 
inserts page numbers at the top of 
each page of the file. 

To suppress the printing of page 
numbers at the top of each page 
of the file, enter y. 

The default is no; the system 
inserts the date at the top of each 
page of the file. 

To suppress the printing of the 
date at the top of each page of 
the file, enter y. 

The default is no; the system 
inserts the time at the top of each 
page of the file. 

To suppress the printing of the 
time at the top of each page of 
the file, enter y. 
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[Double-space?] 



[Left margin (default 
10 spaces)] 



[Text width (default 
65 spaces)] 



[Page length (default 
66 lines)] 



[Top margin (default 
6 lines)] 



[Bottom margin 
(default 6 lines)] 



[Tab width (default 
8 spaces)] 



The default is no; the system 
single spaces the lines of the file 
text. 

To specify double-spacing of the 
lines of the file text, enter y. 

The default sets a left margin 
of 10 spaces on the printed page. 

To set the size of the left margin, 
enter the number of spaces for 
this margin. 

The default sets the text width 
at 65 spaces. 

To set the text width for the file, 
enter the number of spaces you 
want it to occupy. 

The default sets the page 
length at 66 lines. 

To set the page length, enter the 
number of lines you want per 
page, including the top and 
bottom margins. 

The default leaves six blank 
lines for the margin at the top of 
each page. 

To specify the size of the margin 
at the top of each page, enter the 
number of blank lines to allow for 
the margin. 

The default leaves six blank 
lines for the margin at the bottom 
of each page. 

To specify the size of the margin 
at the bottom of each page, enter 
the number of blank lines to allow 
for the margin. 

The default sets eight spaces 
between tab stops. 

To set tab stops, enter the number 
of spaces to allow between them. 
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[Suppress page ejects The default is no; the system 
between files?] starts a new page for each file. 

To print the files as continuous 
text, enter y. 
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INSTALL PROTECTED MODE Command 



Figure 20 INSTALL PROTECTED MODE Command Form 



Install Protected Mode 










[Maximum number of protected 
processes] 




MM 






[Maximum number of concurrent 
protected mode messages] 

[Maximum number of Mover Server 
segments] 







Optional field: 



[Maximum number of 
protected processes] 

[Maximum number of 
concurrent protected 
mode messages] 



[Maximum number of 
Mover Server 
segments] 



It is not necessary to enter any 
values unless you have a 
configuration of protected mode 
programs that exceed the default 
resource allocations. 

The default value for this field 
is 10 protected processes. 

The default value for this field 
is 100 small protected mode 
messages and 25 large protected 
mode messages. 

The default value for this field 
is 200 mover server segments. 

See the BTOS Protected Mode 
Operating System Server (PMOSS) 
Installation Guide for more 
information. 
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INSTALL SPOOLER Command 

Figure 21 INSTALL SPOOLER Command Form 



Install Spooler 



| [Spooler configuration file] 



Optional field: 

[Spooler Enter the name of the custom 

configuration file] Spooler Configuration file. 
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INSTALL TELEPHONE SERVER Command 

Figure 22 INSTALL TELEPHONE SERVER Command Form 



Install Telephone Server 



[Configuration file] 



Optional field: 
[Configuration file] 



If this field is left blank, the 
default configuration file, 
[sys]<sys>TmConfig.sys. is used 
to invoke the Telephone Server. 

If you enter a valid configuration 
file in this field, the information 
is used by the Telephone Server 
system service for the generation 
of dial characters, ringing, etc. 

See the BTOS Voice Services 
Programming Reference Manual 
for more information. 
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IVOLUME Command 



Figure 23 IVOLUME Command Form 



Device name 



0)] 



[Device password] 
Volume name 
[Volume password] 
[System Image (default 
[Log file (default - 0)] 
[Crash file (default - 0)] 
[Max. directories] 
[Max. files on volume] 
[Primary file headers only?] 
[Max. files in Sys Directory] 
[Sys Directory password] 
[Write protect Sys Directory?] 
[Suppress format of medium?] 
[Surface tests] 
[Debug?] 
[Log file] 

[Extended floppy tracks?] 
[Hard disk type code (default - 
[Use ECC format?] 
[Bad spots (See Doc.)] 



|.f!l^£few.,^b.j 






A)] 



Mandatory fields: 
Device name 



Enter the name of the device that 
contains the disk you want to 
format. 



Volume name 



Enter a name (a maximum of 12 
characters) to identify the 
volume. This name must not 
duplicate any other volume or 
device name. 



Optional fields: 
[Device password] 



The default leaves unprotected 
the device that contains the disk 
you are initializing; no password 
is necessary to access it. 

To assign a password to the 
device, enter the word or 
characters (a maximum of 12) you 
want to use for the password. 
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[Volume password] 



[System Image 
(default = 0)] 



[Log file 
(default- 0)] 



The default leaves the volume 
unprotected. No password is 
necessary to access it, and none of 
its directories or files can have 
passwords. 

To assign a password to this 
volume, enter the word or 
characters (a maximum of 12) you 
want to use for the password. 

The default allocates sectors 
for the system image. 

To initialize a nonsystem disk, 
accept the default. 

To initialize a system disk with a 
standard system image, enter 512. 

To initialize a system disk with a 
nonstandard system image, you 
must enter the number of sectors 
required for the system run file. 

For an expanded system, allow 
enough sectors to support another 
BTOS run file. You cannot expand 
the number of sectors later 
without reinitializing the disk. 

The default directs the system to 
allocate sectors for the log file. 

The system writes log entries to 
the system disk only. If this 
volume does not contain a system 
image, accept the default. 

To specify the size of the log file, 
enter the number of sectors to 
allocate for it (2 is recommended). 
If the log file overwrites existing 
entries before it is convenient to 
print, enter a larger number in 
this field. 
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[Crash file 
(default = 0)] 



[Max. 
directories] 



[Max. files on 
volume] 



[Primary file 
headers only?] 



[Max. files in 
Sys Directory] 



After a system crash, 
bootstrapping dumps the entire 
memory contents into a Crash 
Dump file which you specify. This 
file helps determine the cause of 
the crash. 

The default directs the system to 
allocate no sectors for the Crash 
Dump file. 

To create a Crash Dump file, 
enter two sectors for each 1KB of 
memory you want to dump. 

The default directs the system to 
set the maximum number of 
directories for this volume, 
according to the volume size. To 
specify the maximum number of 
directories, enter the number. 

The default sets the maximum 
number of files for this volume, 
according to the volume size. 

To specify the maximum number 
of files, enter the number. 

The default (no) directs the 
system to allocate space for both 
primary and secondary File 
Header Blocks. 

To conserve disk space, enter y to 
allocate space for a primary File 
Header Block only. 

The default directs the system to 
set the maximum number of files 
in the <Sys> directory, according 
to the volume size. 

To specify the maximum number 
of files, enter the number. Allow 
for more files than needed; file 
system performance degrades if 
the directory exceeds 80% 
capacity. Remember that the 
system files reside in the <Sys> 
directory. 
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[Sys Directory 
password] 



[Write protect 
Sys Directory?] 



[Suppress format 
of medium?] 



[Surface tests] 



The default leaves the files in the 
<Sys> directory unprotected; no 
password is necessary to access it. 

To assign a password to the 
<Sys> directory, enter the word 
or characters (a maximum of 12) 
you want to use for the password. 

The default is no; the system does 
not set the protection level of the 
files in the <Sys> directory to 
modify protected. 

To set the default file protection 
level of the files in the <Sys> 
directory to modify protected, 
enter y. You must have specified 
previously both a volume and a 
<Sys> directory password. 

The default (no) does not reduce 
the time required to reinitialize a 
previously formatted volume. You 
should accept the default if you 
are initializing a new disk. 

To reduce the time required to 
reinitialize a medium that was 
previously a formatted volume, 
enter y. 

A surface test writes and reads 
each sector on the disk to ensure 
that it is defect-free. 

You should run surface tests the 
first time you initialize floppy 
diskettes. Do not use any floppy 
diskettes that have surface errors. 

The default values are 1 test for 
floppy diskettes, 1 for initialized 
hard disks, and 8 for uninitialized 
hard disks. 

If you want more tests than the 
default, enter the number you 
want. 
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[Debug?] 



[Log file] 



[Extended floppy 
tracks?] 



[Hard disk type code 
(default = A)] 



The default is no; the system 
does not display debugging 
information. 

To display debugging information 
for system programming, enter y. 

The log file receives a report of 
the IVOLUME operation. If this 
file does not exist, the system 
creates it; if it exists, the system 
automatically appends the log to it. 

The default directs the system to 
display the log only on the screen. 

To receive a printed log of the 
volume initialization, enter the 
name of the file that you want to 
receive this information. 

The default (no) directs the 
system to create a system 
diagnostic file on the innermost 
(extended) six tracks of a floppy 
diskette. 

To use these innermost tracks for 
storage, enter y. 

This field applies only to the 
initialization of B 26, B 27, B 28, 
and B 38 hard disk drives. If you 
are reinitializing a hard disk 
drive, no entry is required in this 
field. 

Refer to Managing Data in the 
BTOS Standard Software 
Operations Guide for a list of the 
parameters of available types of 
hard disk drives. 
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[Use ECC format?] If the field is left blank, the 

system uses the existing CRC or 
ECC format. If the controller 
supports ECC and there is no 
previous format information on 
the disk drive, IVOLUME selects 
the ECC format. 

If you enter y, BTOS uses ECC 
when formatting and writing to 
the disk. If the controller does not 
support the ECC capability or if 
the current OS is not at least 
revision 8.0, BTOS uses the 
existing CRC format. 

Note: If the controller supports ECC, drives 
larger than 40Mb's must use ECC. The error 
message, Drive this size must be formatted 
with ECC, displays if the capacity is greater. 

[Bad spots (See This field applies only to hard 

Doc.)] disk drives. Each drive comes 

with a report of bad spots. Locate 
and read the media defect report 
that came with your system. 

The default indicates to IVOLUME 
that no bad spots exist on the disk. 
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LCOPY Command 

Figure 24 LCOPY Command Form 



u»py 



File list 



[File prefix(w) fro*] 
[File pref lx(es) to] 
[File sufflx(es)] 
[Overwrite ok?] 
[Confln eaon?] 
[Continue on error?] 
(Verify copy?] 









Mandatory field: 
File list 



Enter the name of the file you 
want to copy. 



Optional fields: 

[File prefix(es) 
from] 



[File prefix(es) to] 



The default directs the system to 
use the volume, directory, and file 
prefix (if any) of the current path 
as the file-fronv prefix. 

To add a prefix(es) to the name(s) 
you entered in the File list field, 
enter the characters you want to 
use as a prefix. 

The default directs the system to 
use the volume, directory, and file 
prefix (if any) of the current path 
as the file-to prefix. 

To add a prefix(es) to the name(s) 
you entered in the File list field, 
enter the characters you want to 
use as a prefix. 

If you made only one entry in the 
[File prefix(es) from] field, the 
system copies each file with that 
prefix in the File from field to a 
new file with the prefixes 
specified in this field. 
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[File suffix(es)] 



[Overwrite OK?] 



[Confirm each?] 



[Continue on error?] 



If you did not make an entry in 
the [File prefix(es) from] field, 
the system copies each file of the 
current path listed in the File 
from field to a new file with the 
prefixes specified in this field. 

The default directs the system to 
use the existing file suffixes (if 
any). 

To apply a suffix to the source 
and destination file specification, 
enter the characters to use as a 
suffix. 

If the destination file already 
exists and you accept the default 
(no entry) or enter n, the system 
prompts you for confirmation 
before it overwrites the existing 
file. 

To direct the system to overwrite 
the destination file if it already 
exists, enter y. 

If you accept the default or enter 
n, the system does not prompt 
you for confirmation of each copy 
operation. 

To receive confirmation prompts 
for each copy operation, enter y. 

If you accept the default, LCOPY 
stops when it encounters an error 
and the system prompts you for 
confirmation to continue. 

To have the system report errors 
and continue, enter y. 

To have LCOPY stop when it 
encounters an error, enter n. 
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[Verify copy?] The default is no; the system does 

not verify that the copies are 
correct. 

To have the system verify that 
the copies are correct by reading 
the source and destination files 
and comparing them, enter y. 
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LIST Command 

Figure 25 LIST Command Form 



List 



[File list] 



Optional field: 

[File list] If you accept the default by 

leaving the field blank, the 
system lists the files in the 
directory of the current path. 

To list files in other volumes or 
directories, enter the file 
specification(s). 
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LOGIN Command 

Figure 26 LOGIN Command Form 



Login 



| [volue] 



[Directory] 
[Default file prefix] 
[Passvort] 
[Node] 



Optional fields: 
[Volume] 



[Directory] 



[Default file prefix] 



The default directs the system to 
use the currently logged-in 
volume as the volume name. 

To change the volume name, enter 
the name of the volume you want 
for the path. You need not enclose 
your entry in square brackets. 

The default directs the system to 
use the currently logged-in 
directory as the directory name. 

To change the directory name, 
enter the name of the directory 
you want for the path. You need 
not enclose your entry in angle 
brackets. 

The default directs the system to 
use the currently logged-in default 
file prefix (if any). 

To assign a default file prefix 
name for use as part of a filename 
in calling up a file, enter a name 
ending with a right angle bracket, 
for example, mgr>. 

To remove an assigned default file 
prefix from the path, enter ' ' 
(two single quotation marks with 
no space between) in this field. 
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[Password] 



The default directs the system to 
use the password you assigned (if 
any) when you signed onto the 
system. 

If the directory has an assigned 
password, enter its volume or 
directory password to gain access 
to the directory. 

To remove an assigned password 
from the path, enter ' ' (two single 
quotation marks with no space 
between) in this field. 



[Node] 



This field applies only to 
workstations with B-NET 
(network systems). 

If you accept the default, the 
system uses the currently 
logged-in node (if any). 

To assign or change a node name, 
enter the appropriate name. You 
do not need to enclose the name 
in braces. 

To remove a node name from the 
path, enter ' ' (two single 
quotation marks with no space 
between) in this field. 
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MAINTAIN FILE Command 

Figure 27 MAINTAIN FILE Command Form 



B alntaln File 
| input files" 



[output flies] 

[Log file] 

[Renove deleted records?] 

[Suppress conflrmtlon?] 



]HJ 



Mandatory field: 
Input files 



Enter one or more data files. 



Optional fields: 
[Output files] 



[Log file] 



[Remove deleted 
records?] 



The default varies depending on 
your input files: If all files are 
readable using DAM, the output 
file is a DAM file; otherwise the 
output file is an RSAM file. If an 
output file exists, the system 
overwrites the file. 

To change the default, enter a file 
name. 

The default directs the system to 
only display the log. To direct the 
system to save the log, specify a 
file name. You can then print the 
log by printing that file. 

The default value is no. If the 
output file is an RSAM file, the 
system ignores deleted and 
malformed records. If the output 
file is a DAM file, the system 
places deleted and malformed 
records in the output file. 

To override the default for a DAM 
file, enter y in this field. 
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[Suppress The default value is no. When a 

confirmation?] malformed record appears in the 

input file, the system displays a 
message specifying its file address 
and length. 

To override the default, enter y in 
this field. 
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MAKE TRANSLATION FILE Command 

Figure 28 MAKE TRANSLATION FILE Command Form 



Make Translation File 



source file nam | 
Translation file nam 



Mandatory fields: 

Source file name Enter the name of the source file 

you want to convert into a 
Translation file. 

Translation file Enter a name for the Translation 

name file. 
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MERGE Command 

Figure 29 MERGE Command Form 



Merge 



Input file 



Output files 

Keys 

[Log file] 

[Suppress confirmation?] 



Mandatory fields: 
Input file 

Output files 
Keys 



Enter the name(s) of the file(s) 
you want to merge. 

Enter the name(s) of the file(s) to 
which you want the output 
written. 

This field specifies how the sort 
keys are embedded within each 
record. 



Optional fields: 
[Log file] 



[Suppress 
confirmation?] 



Specifies the file name to which 
the status report and the merge 
statistics are written. 

If you enter y, the MERGE 
operation skips any corrupt input 
records and searches for the next 
valid record. 

If you enter n, the MERGE 
operation skips any corrupt input 
records and displays a message 
inquiring if you want to continue 
or terminate the MERGE 
operation. 
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For more information, refer to the 
BTOS Sort/Merge Operations 
Reference Manual. 
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NEW COMMAND Command 

Figure 30 NEW COMMAND Command Form 



New Command 



Command name 



Run file 
[Field names] 
[Description] 
[Overwrite OK?] 
[Case (default - 00)] 
[Command file] 



Mandatory fields: 
Command name 

Run file 



Enter the new command name. 

Enter the complete run file name 
([VolName]<DirName> FileName) 
or, if the command is an 
Executive Intrinsic Command, 
enter the appropriate symbol 
(refer to Adding Executive 
Commands in the BTOS Standard 
Software Operations Guide'). 



Optional fields: 
[Field names] 



[Description] 



[Overwrite OK?] 



The default is no field names. 

To specify parameter fields, enter 
the name of each field. Enclose 
each field name in single 
quotation marks. 

The default is no HELP 
description. To specify a HELP 
description, enter a description 
enclosed in single quotation 
marks. 

The default (y) directs the system 
to prompt you for confirmation 
before overwriting an existing 
command. 
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If you enter n, and the command 
already exists, the system cancels 
the new command. 



[Case (default 
00)] 



[Command Hie] 



Case values specify which 
command called the run file when 
more than one path of execution 
exists within the run file. (The 
run file queries the case value.) 
The default is 00. 

Enter the case value (if 
necessary). Enclose the case value 
in single quotation marks. 

The default directs the system to 
add this command to the 
command file currently in use. 

To add this command to a 
different command file, enter the 
name of the command file. 
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PATH Command 

Figure 31 PATH Command Form 



Path 



[Volun] 



[Directory] 
(Default file prefix] 
[Passwrd] 
{Mode] 



Optional fields: 
[Volume] 



[Directory] 



[Default file prefix] 



The default directs the system to 
use the currently logged-in 
volume as the volume name. 

To change the volume name, enter 
the name of the volume you want 
for the path. You do not need to 
enclose your entry in square 
brackets. 

The default directs the system to 
use the currently logged-in 
directory as the directory name. 

To change the directory name, 
enter the name of the directory 
you want for the path. You do not 
need to enclose the name in angle 
brackets. 

The default directs the system to 
use the currently logged-in default 
file prefix (if any). 

To assign a default file prefix 
name for use as part of a filename 
in calling up a file, enter a name 
ending with a right angle bracket, 
for example, mgr>. 

To remove an assigned default file 
prefix from the path, enter * ' 
(two single quotation marks with 
no space between) in this field. 
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[Password] The default directs the system to 

use the password you assigned (if 
any) when you signed onto the 
system. 

If the directory has an assigned 
password, enter its volume or 
directory password to gain access 
to the directory. 

To remove an assigned password 
from the path, enter ' ' (two single 
quotation marks with no space 
between) in this field. 

[Node] This field applies only to 

workstations with B-NET 
(network systems). 

If you accept the default, the 
system uses the currently 
logged-in node (if any). 

To specify a node name, enter the 
appropriate name. You do not 
need to enclose the name in 
braces. 

To remove a node name from the 
path, enter ' ' (two single 
quotation marks with no space 
between) in this field. 
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PLAYBACK Command 

Figure 32 PLAYBACK Command Form 



Playback 


File ; ^ : ' \ < "-V ^^^^S^Sl^^^R^^^^^ipM.sltl!^s' | 





Mandatory field: 

File Enter the name of a file. 
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PLOG Command 

Figure 33 PLOG Command Form 



PLOQ 



| [Error type (cr,8,IryP,Cl,H)] | (HUT 
[Print to] 
[voiuK nan] 
[After oate/Tlm] 



Optional fields: 

[Error type (Cr, B, 
In, D, CI, Is)] 



The default directs the system to 
display all entries in the log file. 

To specify the type(s) of errors 
you want the system to display, 
enter one of the following codes: 

Error Code Code 

system crashes Cr 

system boot errors B 

system initialization errors In 

disk errors D 

cluster communication errors CI 

ISAM errors Is 



[Print to] 



[Volume name] 



The default directs the system to 
display the log file on the screen. 

To write the log to a file or print 
it, enter the name of the 
destination file or the printer 
device name. 

The default directs the system to 
display the log file for the current 
[Sys] volume. 

To specify the volume of the log 
file, enter the volume name. 
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[After date/time] The default directs the system to 

display all the log file entries 
after the earliest date and time 
recorded in the file. 

To display log file entries after a 
particular date/time, enter the 
starting date/time. 
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PRINT Command 

Figure 34 PRINT Command Form 



Print 



| File list 



[Queue nan (default • SPL)] 
[Matter of copies] 
[Delete after printing?] 
[Special form nam] 
[Print aheel nam] 
[Printing aode] 
[Align for*?] 
[After date/tlm] 
[Security mete?] 
[Priority] 
[Oonflra each?] 



Mandatory field: 
File list 



Enter the name of the file you 
want to print. 



Optional fields: 

[Queue name 
(default = SPL)] 



[Number of copies] 



[Delete after 
printing?] 



The default directs the system 
to use [Spl] as the scheduling 
queue. 

To specify the scheduling queue 
that contains the queue entry 
generated by this print request, 
enter the queue name. The name 
must match a queue name defined 
for the system. 

The default directs the system to 
print one copy. 

To specify the number of copies 
of the file to print, enter the 
number. 

If you accept the default (no 
entry) or enter n, the system does 
not delete the file(s) after 
printing it. 
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[Special forms name] 



[Print wheel name] 



[Printing mode] 



[Align form?] 



[After date/time] 



[Security mode?] 



To direct the system to delete the 
file(s) after printing it, enter y. 

If you accept the default, the 
printer does not pause before 
printing to load special paper. 

To use special paper to print the 
file, enter the name (a maximum 
of 12 characters) of the paper. 
The printer pauses before printing 
so that you can load this paper. 

The default does not specify a 
particular print wheel. 

To use a specific print wheel, 
enter the name (a maximum of 12 
characters) of the print wheel. 
The printer pauses before printing 
so you can install the print wheel. 

The default is the ASCII mode. 

To specify the Plotter mode, enter 
the letter p. 

To specify the Binary mode, enter 
the letter b. 

The default is no; the printer does 
not pause for forms alignment. 

To direct the printer to pause 
after printing the first page so 
that you can align the paper, 
enter y. 

The default directs the system to 
print the file as soon as possible. 

To specify the earliest date/time 
for the system to print the file, 
enter the date/time in this format: 

Mon Jun 3 1985 8:00 pm 

The default is no; the printer does 
not pause for a password entry 
before printing the file(s). 
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[Priority] 



[Confirm each?] 



To direct the printer to pause for 
a password entry before printing 
the file, enter y. 

Scheduling queue priorities are 
0-9, with as the highest. 

The default sets the priority at 5. 

To assign the file a priority in the 
Scheduling queue, enter the 
priority number. 

The default is no; the system 
prints the file(s) without 
prompting you for confirmation. 

To receive prompts to confirm the 
printing of the file(s), enter y. 
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RECORD Command 

Figure 35 RECORD Command Form 



File to record on 



Mandatory field: 
File to record on 



Enter the file name that specifies 
the file containing the commands 
you are recording. 
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REMOVE COMMAND Command 

Figure 36 REMOVE COMMAND Command Form 



Rawwe cowcno 
| oonwand nam \ 
[Comonrf file] 



Mandatory field: 
Command name 



Enter the full name of the 
command you want to remove or 
its unique abbreviation. 



Optional field: 
[Command file] 



If you accept the default by 
leaving this field blank, the 
system removes the command 
from the command file currently 
in use. 

To remove a command from a 
command file not currently in use, 
enter the file specification for the 
command file in this field. 
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REMOVE DIRECTORY Command 

Figure 37 REMOVE DIRECTORY Command Form 



Reeove Oirectory 



Old directory nawe(s) | 

[voluw or directory password] 
[Oeiete all files in directory?] 
[Oonflni each tftlle deleting?] 



Mandatory field: 
Old directory name(s) 



Enter the name of the directory 
you want to delete. 



Optional fields: 

[Volume or directory 
password] 



[Delete all files 
in directory?] 



[Confirm each while 
deleting?] 



The default indicates that a 
password is not assigned to the 
directory(ies) or its volume(s). 

If the directory or its volume has 
a password, enter the password in 
this field. 

The default is no; the system does 
not delete any files in any 
directories. 

To delete all the files in all the 
directories listed in the Old 
directory name(s) field, enter y. 

The default is no; the system does 
not prompt you to confirm the 
deletion of each file. 

To receive a prompt to confirm 
the deletion of each file in each 
directory, enter y. 
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RENAME Command 

Figure 38 RENAME Command Form 



Renawe 

| Old file nawe | 
New file ram 
[Ovemlte ok?] 
[Oonflni cacfff] 



Mandatory fields: 
Old file name 

New file name 



Enter the name of the file you 
want to change. 

Enter the new name for the file. 



Optional fields: 
[Overwrite ok?] 



The default is no entry. If you 
accept the default and the name 
you enter in the New file name 
field already exists, the system 
displays the following when you 
complete the command form and 
press GO: 

File [File name] already exists 

Overwrite? 

(Press GO to confirm, CANCEL 

to deny, or FINISH to stop 

command.) 

If you enter n in this field, the 
system does not perform an 
overwrite operation. 

To assign the name entered in the 
New file name field to the file in 
the Old file name field, enter y. If 
a file with the New file name 
parameter already exists, the 
system overwrites that file and 
assigns the New file name 
parameter to the Old file name file. 
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[Confirm each?] The default is no; the system does 

not prompt you to confirm each 
RENAME operation. 

To receive prompts to confirm 
each rename operation, enter y. 
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REPLAY Command 

Figure 39 REPLAY Command Form 



Replay 

I File | iiJ=;=lj;i;=HI;ljljl;ijlj;il;i|:j:;l;i;l;l|l; 
[Your nam] 



Mandatory field: 

File Enter the same name of the file 

you created or edited with the 
EDIT command, or the name of a 
file in which you want to save the 
replay session. 

Optional field: 

[Your name] If you accept the default, the 

system uses the typescript file .ts 
if no user name was logged on 
when you activated the Editor, or 
the default user.ts file if a user 
name was logged on. 
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RESTORE Command 

Figure 40 RESTORE Command Form 



Restore 

{ (Archive File} 



[File list froa] 
(File list to) 
[Overwrite ok?] 
[Oonf Ira each?) 
[Sequence nueber] 
[Merge eith existing file?] 
[List rues only?] 
[Log file] 



Optional fields: 
[Archive File] 



[File list from] 



[File list to] 



The default is the file name, 
[Archi ve]<Sys> .0 1 . 

To specify an archive file created 
with BACKUP VOLUME or 
SELECTIVE BACKUP that has a 
name other than Archive, enter 
the file name. 

If you accept the default, the 
system restores all the files on the 
archive file. 

To specify a list of files you want 
to restore, enter the file names in 
the following format: 
<DirName>FileName. Do not use 
volume names. 

If you accept the default, the 
system restores the files to the 
directory and file they were in 
when they were archived, but 
places them in the currently 
logged-in volume. 
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To restore the files to a new file 
destination, enter the new file 
name(s) in the following form: 

[VolName]<DirName>FileName 

The volume and directory names 
are optional. If you enter only a 
file name, the system restores the 
files to the currently logged-in 
volume. 



[Overwrite ok?] 



[Confirm each?] 



[Sequence number] 



If you accept the default (no 
entry) or enter n, the system 
prompts you for confirmation 
before it overwrites any existing 
file of the same name. 

To overwrite any existing file of 
the same name before restoring a 
new one, enter y. 

If you accept the default (no 
entry) or enter n, the system does 
not prompt you for confirmation 
before restoring each file. 

To receive prompts for 
confirmation before restoring each 
file, enter y. 

The default is 1 (the first volume 
of the archive file). 

To specify the volume you want 
to begin the RESTORE operation 
with, enter the sequence number 
of the volume. 



[Merge with 
existing file?] 



If you accept the default (no 
entry) or enter n, the system 
overwrites the sectors of the 
target file with zeros when it 
detects any input/output errors 
on the archive file. 

To bypass overwriting sectors of 
the target file when the system 
detects input/output errors on 
corresponding sectors of the 
archive file, enter y. 
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[List files only?] The default is no; the system 

restores the files indicated. 

To list the files on the archive file 
only, not restore them, enter y. 

[Log file] If you accept the default, the 

system displays the log on the 
screen only. 

To write a report of the RESTORE 
operation to a file, enter the name 
you want to use for the file. 

If a log file currently exists, the 
system appends the log to it. If a 
log file does not exist, the system 
creates one with the name you 
specify here. 

To send the log file directly to a 
printer, enter a device name (for 
example, [Lpt]). 
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RUN Command 

Figure 41 RUN Command Form 



Run 


i Run me 1 1;!;;:*;:;:;:;*!!;;;*;:;*;:;;;:;* 


[case] 


[CDMtand] 


[Paraaeter l) 


[Paraaeter 2) 


[Paraaeter 3] 


[Paraaeter 16] 



Mandatory field: 
Run file 



Enter a run file name. 



Optional fields: 
[Case] 



[Command] 



[Parameter 1] 



[Parameter 16] 



The default is 00. 

To change the default, you enter a 
two-digit case value (a string to 
identify the command if more 
than one command can call the 
run file). 

The default is no command name. 

To specify a command name, you 
enter it in this field. 

The default is none. 

You enter parameters for the 
first command form field here in 
order (up to 16). 
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RUN FILE Command 

Figure 42 RUN FILE Command Form 



File 



[Parameters] 



Mandatory field: 
File name 



Enter a run file name. 



Optional field: 
[Parameters] 



The default is no parameter. To 
specify parameters, enter them in 
this field. 



Commands 



1-75 



SCREEN SETUP Command 

Figure 43 SCREEN SETUP Command Form 



Screen Setup 

I [Reverse video?] 



[Large characters?) 

[Screen length (default - full screen)] 

[Supress character attributes?] 

[Supress pause between pages?] 

[Color (e.g.. Green)] 

[Screen timeout (in minutes)] 



Optional fields: 
[Reverse video?] 



[Large characters?] 



[Screen length 
(default = full 
screen)] 



[Suppress character 
attributes?] 



The default is no; the system 
displays light characters on a 
dark background. 

To display dark characters on a 
light background, enter y. 

This field applies only to B 22 
and B 27 workstations, which 
have wide screen capabilities. 

The default is no; the system sets 
the screen width at 132 columns. 

To set the screen width at 80 
columns, enter y. 

The default sets the screen 
length at full screen. 

To specify the screen length, 
enter the desired length in 
number of lines. 

The default is no; the system does 
not suppress character attributes 
and the command form parameter 
fields remain in reverse video. 

To suppress character attributes 
and eliminate the reverse video 
highlight from command form 
parameter fields, enter y. 
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[Suppress pause 
between pages?] 



[Color (e.g., 
Green)] 



[Screen timeout 
(in minutes)] 



The default is no; the system 
prompts you to press the NEXT 
PAGE key before scrolling any 
information off the screen. 

To suppress a pause between 
pages displayed on the screen, 
enter y. 

This field applies to color 
workstations only. 

The system sets this parameter to 
the color you specified most 
recently. 

To specify a color other than 
green, enter the name of the color. 

The default does not use the 
screen timeout feature; the screen 
remains on as long as the 
workstation is on. 

To use the screen timeout feature, 
enter the number of minutes delay 
after an entry before the system 
turns off the screen. 



Commands 



1-77 



SELECTIVE BACKUP Command 



Figure 44 SELECTIVE BACKUP Command Form 



Selective Backup 



I File list 



[Incremental from (e.g., Mon Jun 1 1981 8:00 pm)] 

[Confirm each?) 

[Archive file} 

[Delete existing archive file?] 

[Log file] 

[Verify write?] 



Mandatory field: 
File list 



Enter the name of the files you 
want to backup. 



Optional fields: 

[Incremental from 
(e.g., Mon Jun 1 
1981 8:00 pm)] 



[Confirm each?] 



[Archive file] 



The default directs the system 
to backup all files. 

To backup files modified on or 
before a specific date, enter the 
date. The time is optional. If you 
do not specify a time, the system 
backs up all files from 12:00 AM 
(midnight) of the specified day. 

The default is no; the system 
backs up the files without 
individual confirmation. 

To receive confirmation prompts 
before the system copies a file, 
enter y. 

If you accept the default, the 
system creates an archive file 
named [Archive]<Sys>.nn, where 
nn represents a number that the 
system supplies. 
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To assign a name other than 
Archive to this file, enter the 
name you want to use. You must 
also specify a directory name so 
that adding a sequence number 
produces a valid file specification. 
For example, you specify 
[XYZ]<Sys> to get [XYZ]<Sys>.01, 
[XYZ]<Sys>.02, etc., or 
[XYZ]<Sys>ABC to get 
[XYZ]<Sys>ABC.01, 
[XYZ]<Sys>ABC.02, etc. 

[Delete existing If you accept the default (no 

archive file?] entry) or enter n and the archive 

file already exists, the system 
displays the following prompt: 

File already exists. Delete? 
(Press GO to confirm, CANCEL 
to deny, or FINISH to return to 
the Executive.) 

To automatically overwrite the 
existing archive file, enter y. 

[Log file] The default directs the system to 

display the log on the screen only. 

To write a report of the backup 
operation to a file, enter the file 
name (for example, BackupLog). 
If the file already exists, the 
system appends the log to it; if it 
does not exist, the system creates it. 

To send the log file directly to a 
printer, enter a device name (for 
example, [Lpt]). 
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[Verify write?] The default is no; the system does 

not perform a physical read after 
each write to insure that the 
file(s) you are backing up are the 
same as the previously backed up 
file(s). 

Note: it is probably not necessary to fill in 
the [Verify write?] field if you have verified 
the hard disk or diskette for bad spots using 
the IVARCHIVE command. 

To automatically verify each read 
and write operation for the file(s) 
that you are backing up, enter y. 
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SET DIRECTORY PROTECTION Command 

Figure 45 SET DIRECTORY PROTECTION Command Form 



set Directory Protection 



I Directory 



(e.g., sys) 



[voluie or directory passvord] 
[Nev protection level (e.g., 15)) 
[Nev password] 



Mandatory field- 
Directory name 



Enter the name of the existing 
directory whose protection you 
want to change. 



Optional fields: 

[Volume or 
directory password] 



[New protection 
level (e.g., 15)] 



[New password] 



The default indicates that this 
directory and its volume currently 
do not have passwords. 

If this directory currently has a 
password, enter it or its volume 
password in this field. 

The default is no change. 
To change the existing default file 
protection level for this directory, 
enter the decimal value for the 
new protection level. 

The default is no change to the 
current password status. 

To add or change a password, 
enter the word or characters (a 
maximum of 12) that you want to 
use for the password. 

To delete an existing directory 
password, enter ' * (two single 
quotation marks with no space 
between) in this field. 
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SET FILE PREFIX Command 

Figure 46 SET FILE PREFIX Command Form 



set File Prefix 



Default file prefix 



Mandatory field: 

Default file prefix Enter the name of the file prefix 

you want the system to use as a 
default. 
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SET PROTECTION Command 

Figure 47 SET PROTECTION Command Form 



Set Protection 
| File list 



New protection level (e.g., 15) 
[New password] 
[Conflrn each?] 



Mandatory fields: 
File list 



New protection 
level (e.g., 15) 

Optional fields: 
[New password] 



[Confirm each?] 



Enter the name of the file or list 
of files you want to protect. If the 
file is in a volume or directory 
other than that of the current 
path, you must enter a full file 
specification. 

Enter the decimal value of the 
protection level you want to 
assign to the file(s). 



If you accept the default, the 
system does not assign a 
password to the file(s). 

To assign a new password to the 
file(s), enter a word or characters 
(a maximum of 12) that you want 
to use for a password. 

If you entered a protection level 
that requires a password in the 
New protection level field, you 
must enter a parameter in this 
field. 

If you accept the default (no), the 
system does not prompt you for 
confirmation before setting the 
protection level of each file. 

To receive confirmation prompts 
before a protection level is set for 
each file, enter y. 
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SET TIME Command 

Figure 48 SET TIME Command Form 



Date/Tine (e.g., Hon Jun 1, 1981 8:00 pw) 



Mandatory field: 
Date/Time 



You should use the following 
guidelines when you enter a 
parameter in this field: 



Day of week 



Month 



Day of Month 



Year 



Abbreviated 
Form 



Time 



Enter the current 
day. 

Enter the current 
month. 

Enter a number 
between 1 and 31. 

Enter the current 
year. 

You can enter the 
current Month, day, 
and year combined in 
an abbreviated form 
(for example, 6/4/85 
for June 4, 1985). 

Enter the current 
hour, minute, and, 
optionally, time 
qualifier in the 
format: 7:00 AM. 

You can use the 
24-hour notation of 
two digits to specify 
the hour (for 
example, 14:22). 
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SOFTWARE INSTALLATION Command 

Figure 49 SOFTWARE INSTALLATION Command Form 



Software Installation 


[Cmd file] SHI 


1 


[Files to] 
[Install file] 



Optional fields: 
[Cmd File] 



[Files to] 



[Install file] 



The default is the standard 
system command file, 
[Sys]<Sys>Sys.cmds. 

To specify a different command 
file, enter the file name or 
complete file specification. 

The default is the system 
directory. 

To specify a different directory, 
enter the directory name. 

The default installation file is 
[fO]<Sys>Install.sub. 

If the application program uses a 
different installation file, specify 
the file name in this field. 
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SORT Command 

Figure 50 SORT Command Form 



Sort 

| input f lies' 



Output file 

Keys 

[Stable sort?] 

[tork File 1] 

[•ork File 2] 

[Log file] 

[Suppress confirmation?] 






Mandatory fields: 
Input files 

Output file 
Keys 



Enter the name of the file(s) that 
you want to sort. 

Enter the name of the file(s) to 
which you want the records 
written. 

Specifies how the sort keys are 
embedded within each record. 
Refer to the BTOS Sort/Merge 
Operations Reference Manual for 
more information. 



Optional fields: 
[Stable sort?] 



[Work File 1] 



Enter y if you want the input 
records that have equal sort keys 
to appear in the output file in the 
same order as they appear in the 
input file. 

The default is no. 

SORT requires two work files, 
each the same size as the input 
file. Enter the name of an existing 
file; or, if you specify a file that 
does not exist, SORT creates it 
and deletes it at the end of the 
operation. 
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[Work File 2] 



[Log file] 



If you do not specify a work file, 
the system work file 
(SortWorkfilel.Dat) is placed on 
the logged-in volume and 
directory. 

SORT requires two work files, 
each the same size as the input 
file. Enter the name of an existing 
file; or, if you specify a file that 
does not exist, SORT creates it 
and deletes it at the end of the 
operation. 

If you do not specify a work file, 
the system work file 
(SortWorkfile2.Dat) is placed on 
the logged-in volume and 
directory. 

Enter the filename to which you 
want the status report and the 
sort statistics written. 



[Suppress 
confirmation?] 



If you enter y, SORT skips any 
corrupt records and searches for 
the next valid record. 

If you enter n, SORT skips any 
corrupt records and displays a 
message inquiring if you want to 
continue or terminate the SORT 
operation. 
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SUBMIT Command 

Figure 51 SUBMIT Command Form 



Submit 



File list 



J! 



[ Par— t ars] 
[Face Expansion?) 
[Show Expansion?] 



Mandatory field: 
File list 



Enter the name of the file you 
want the system to read and 
execute. 



Optional fields: 
[Parameters] 



[Force Expansion?] 



[Show Expansion?] 



Specifies parameters (up to 10) 
that replace escape sequences in 
the form %n in the file specified 
in the File list field. The first 
parameter replaces all instances 
of %0; the second, %1; and so on 
through %9. 

The default is no. 

Enter y to have the system force 
the expansion of submit escape 
sequences in a file (even though 
you are not passing parameters). 

The default is no. 

Enter y to direct the system to 
display the file expansion. This is 
useful for debugging complicated 
conditional expansions. 
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TYPE Command 

Figure 52 TYPE Command Form 



Type 

I File list | Elf| 
[Confirm each?] 



Mandatory field: 
File list 



Enter the name of the file you 
want to display. You can use a 
wildcard character in this field. 



Optional field: 
[Confirm each?] 



The default is no; the system does 
not prompt you for confirmation 
before displaying each fiel you 
request. 

To receive prompts to confirm 
each file, enter y. 
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USER FILE EDITOR Command 

Figure 53 USER FILE EDITOR Command Form 





User File Editor 










User name 










[Old password] 
[New password] 
[User template f 
[Command file] 


le] 







Mandatory field: 
User name 



To create a new User file, enter a 
new user name. You cannot enter 
a wild card character. 

To modify an existing User file, 
enter the user name 
corresponding to that field. 



Optional fields: 
[Old Password] 



[New Password] 



[UserTemplate file] 



The default is the currently 
logged-in password. The system 
denies access to a protected file if 
you attempt to open it without a 
valid password. 

To access an existing User file 
with password protection, enter 
that password in this field. 

The default is no password. 

To assign password protection to 
this User file, enter a volume or 
file password in this field. 

The default User File Template is 
[Sys]<Sys>UserFileTemplate.sys 
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To specify a User File Template 
other than the default, enter the 
Template file name in this field. 

[Command file] The default command file is 

[Sys]<Sys>Sys.cmds. 

To specify a command file other 
than the default for this User file, 
enter the command file name in 
this field. 
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VIDEO Command 

Figure 54 VIDEO Command Form 



Video 








[Suppress pause 
between pages?] 




**«**>•• iiiiiiiiiiiiiiii l 




[Screen timeout 
(in minutes)] 

[Color (default - gre 

[132 columns 
(B 22, B 27 only?}] 


en)] 





Optional fields: 

[Suppress pause 
between pages?] 



[Screen timeout 
(in minutes)] 



[Color (default 
green)] 



The default is no; the system 
prompts you to press NEXT 
PAGE before scrolling any 
information off the screen. 

To suppress a pause between 
pages displayed on the screen, 
enter y. 

The default does not use the 
screen timeout feature; the screen 
remains on as long as the 
workstation is on. 

To use the screen timeout feature, 
enter the number of minutes delay 
after an entry before the screen 
turns off. 

This field applies to color 
workstations only. 

The default sets green as the color 
for the display. 
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To specify a default color other 
than green, enter the name of the 
color. 

[132 Columns (B 22, This field applies only to B 22 
B 27 only)?] and B 27 workstations, which 

have wide screen capabilities. 

The default is no; the system sets 
the screen width at 80 columns. 

To set the screen width at 132 
columns, enter y. 
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VOLUME STATUS Command 

Figure 55 VOLUME STATUS Command Form 



volume status 



[volume or device naae] 

[Details?] 

[Print file] 

[Directory spec (default • '*')] 

(Include temporary directories?] 



Optional fields: 

[Volume or device 
name] 



[Details?] 



[Print file] 



[Directory spec 
(default = ***)] 



The default is the volume of the 
current path. 

To display the status of a volume 
other than that of the current 
path, enter the volume name. 

The default is no; the system 
displays the status information 
with no details. To display 
detailed status information for 
the volume, enter y. 

If you accept the default, the 
system does not store or print the 
information the command 
generates. The information 
appears on the screen only. 

To store the information in a file 
from which you can later display 
or print it, enter a file name for 
the storage file. 

To send the information directly 
to a device such as a printer, 
enter an appropriate device name. 

The default directs the system to 
display volume status information 
for all the directories in the 
volume. 
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To display status information for 
specific directories only, enter the 
name(s) of each directory 
enclosed in angle brackets. 

[Include temporary The default is no; the system does 
directories?] not include information about 

temporary directories in the 
volume status display. 

To include information about 
temporary directories in the 
volume status display 
information, enter y. 
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WRITE HARDWARE ID Command 

Figure 56 WRITE HARDWARE ID Command Form 



•rite Hardware ID 

| integer value (1-126) | {[ 



Mandatory field: 

Integer value (1-126) Enter a number from 1 through 

126 for your workstation that is 
different from the numbers 
assigned to the other 
workstations on the cluster. 
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Commands 



XESOFTWARE INSTALLATION Command 

Figure 57 XESOFTWARE INSTALLATION Command Form 



XE Software Installation 










[Cmd file] 








''.. *.t' : 






[Files to] 
[Install file] 













Optional fields: 
[Cmd File] 



[Files to] 



[Install file] 



The default is the standard 
XE 520 command file, 
[!Sys]<Sys>Sys.cmds. 

To specify a different command 
file, enter the file name or 
complete file specification. 

The default is the XE 520 
directory. 

To specify a different directory, 
enter the directory name. 

The default installation file is 
[fO]<Sys>Install.sub. 

If the application program uses a 
different installation file, specify 
the file name in this field. 



Section 2 m 

Tables 

Introduction 

This section contains a compilation of tables taken from 
the BTOS Standard Software Operations Guide and 
consolidated in one place for easy access. 

This section begins with a list of tables. This list, along 
with the index, should help you easily find the 
information you need. 

Table Title 

1 BTOS Memory and Disk Space Requirements 

2 System Images for Cluster Workstations with 
Local Hard Disk File Storage 

3 User File SignOn Entries 

4 Cluster Communications Lines 

5 Keyboard Editing Functions 

6 Device Parameters 

7 Date/Time Configuration File Codes 

8 Spooler Configuration File Entries 

9 Queue Index File Entries 

10 Executive Printing Commands 

1 1 Printer Device Names 

12 Typical Drive Device Names 

13 Parameters of Available Hard Disk Drives 

14 Bad Spot Reports and Sample Entries 

15 Commonly Used File Suffixes 

16 File Specifications for Listing Files 

17 Protection Levels 

18 Sample SELECTIVE BACKUP File List 
Parameters 

19 Special Command Edit Functions 

20 Executive Intrinsic Commands 

21 Escape Sequence Components 

22 Hexadecimal Codes for Special Keys 
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Table 1 BTOS Memory and Disk Space Requirements 


Single Multi- 
Partition Partition 
Configuration (KB) (KB) 


Disk 

Space 

(Sectors) 



B 21-1 Cluster 


65 


— 


— 


B 21-3 Cluster 
with local 
file storage 

B 21-4 Cluster 
with local 
file storage 


95 
100 


125 


— 


B 22 Cluster 


85 


100 


— 


B 22 Cluster 
with local 
file storage 


110 


150 




B 26 Standalone 


115 


140 


1400/2900 


B 26 Master 


175 


195 


700** 


B 26 Cluster 


100 


115 


— 


B 26 Cluster 
with local 
file storage 


120 


155 




B 27 Standalone 


140 




150 


B 27 Master 


220 


230 


1400/2900^ 


B 27 Cluster 


140 


145 


700** 


B 27 Cluster 
with local 
file storage 


160 


190 




B 28/38 Standalone 


115 


162 


1400/2900' 


B 28/38 Master 


195 


237 


700** 


B 28/38 Cluster 


100 


137 


— 


B 28/38 Cluster 

with local 
file storage 


120 


177 





* Minimum/Optional requirements (standard software). 

"Cluster operating systems require 170 to 300 additional sectors each. 

Note: B 28 and B 38 customized operating systems will be approximately 
22k larger, due to protected mode support. 
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Table 2 


System Images 
File Storage 


for Cluster Workstations with Local Hard Disk 


Workstation Type 


System 


Image 





B 21-4 Cluster Workstation Ws253>Syslmage.Sys 

B 26 Cluster Workstation Ws250>Syslmage.Sys 

B 27 Cluster Workstation Ws125>Syslmage.Sys 

B 28 Cluster Workstation Ws240>Syslmage.Sys 

B 38 Cluster Workstation Ws240>Syslmage.Sys 
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Tables 



Table 3 User File SignOn Entries 



Keyword 



Parameter 



:SignOnVolume: 

.SignOnDirectory: 

•.SignOnFilePrefix: 

:SignOnPassword: 

.SignOnExitFile: 



:SignOnTextFile: 



.SignOnChainFJIe: 



specifies the volume in the default path 

specifies the directory in the default path 

specifies a file prefix in the default path 

specifies a password required to sign on to the system 

specifies the run file of the environment the 
system loads whenever you exit an application or 
enter ACTION-FINISH 

For example, to return to the Executive when you 
finish a session with an application, enter the 
Executive run file [Sys]<Sys>Exec.run. 

specifies one or more files containing text that the 
system displays when you sign on 

You can specify the default text file 
[Sys]<Sys>System.txt and/or other files 
containing messages you want the system to 
display before activating the initial environment. 

The system also displays any text you enter 
between the end of the last (or only) text file and 
the first colon of the next entry in the User file. 

specifies the run file of the initial environment 

For example, to activate the Executive when you 
sign on, you enter the Executive run file, 
[Sys]<Sys>Exec.run. 
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Table 3 User File SignOn Entries (continued) 



Keyword 



Parameter 



To bypass the Executive and activate an 
application, programming language, or BTOS 
utility, enter the appropriate run file (for 
applications, programming languages, and utilities, 
refer to the applicable documentation. 

If the Executive command that activates the 
application, programming language, or BTOS utility 
has a command form, you can specify one or more 
parameters; use the following guidelines: 

d the parameter(s) must appear 
in the line(s) immediately 
following the SignOnChainFile 
entry. 

d the line(s) containing the 
parameter(s) do not begin with 
a colon. 

a the first parameter must be 
the command that activates the 
application, programming 
language, or BTOS utility. 

d the parameter entries can not 
include wild card characters. 

d if you are using the word 
processing program to edit the 
file, use the SHIFT-RETURN key 
combination to end each line. 

d two or more blank lines must 
follow the last parameter 
entry. 

a the next line following the 
blank lines must begin with a 
colon (even if it contains no 
other entry). 



:ExecCmdFile: 



specifies the Executive command file 

If none is specified, the system uses the default 
file [Sys]<Sys>Sys.cmds. 
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Table 4 Cluster Communications Lines 


Line Number 


Communications Line 





1-4 


Standard Channel 
Reserved, XE 500 
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Table 5 Keyboard Editing Functions 



Key 



Function 



ACTION-DELETE 

ACTION-OVERTYPE 

BACKSPACE 



CANCEL 



CODE-DELETE 

CODE-Left Arrow 
CODE-Right Arrow 
DELETE 
Down Arrow 
F1 



clears the Type-Ahead buffer 

turns off the screen (press any key to turn it on again) 

d in insert mode (OVERTYPE key 
not activated), deletes the 
last character entered 

a in overtype mode, moves the 
cursor one space to the left 

d terminates the present command 
form and returns to a new 
command form without 
completing the execution of 
the original command 

a terminates a multipage display 
initiated by the TYPE and DUMP 
commands 

deletes the entire entry in a field where the cursor 
is located 

moves the cursor to the leftmost column 

moves the cursor to the rightmost column 

deletes the character at the cursor position 

moves the cursor to the next field of a command form 

a activates the Redo feature of 
the Executive 

Note: The Redo feature is not 
available for some commands. 

o activates the Retry feature of 
the LCOPY command 
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Table 5 Keyboard Editing Functions (continued) 



Key 



Function 



FINISH 



GO 



HELP 



Left Arrow 
NEXT 
NEXT PAGE 

OVERTYPE 



ends the execution of a command and returns to 
the Executive Command field 

initiates a command when you complete the 
command form 

a displays a list of all the 
available Executive commands 

a (pressed twice) displays a 
description of each available 
Executive command 

a (pressed after partially 

entering a command name) lists 
and describes the Executive 
commands that match the 
partially entered name 

a (pressed for a specific 
command) displays a short 
description of the command, 
the name of its run file, the 
command case, and the command 
form 

moves the cursor left one column 

moves the cursor to the next field of a command form 

displays the next page when the current command 
requests more than one screen of information 

places the system into overtype mode and lights 
the indicator on the OVERTYPE key. In this 
mode, the characters you type overwrite existing 
characters at the same positions. 



Tables 



2-9 



Table 5 Keyboard Editing Functions (continued) 



Key 



Function 



RETURN 
Right Arrow 
SCROLL UP 

SHIFT-GO 

SHIFT-Left Arrow 
SHIFT-Right Arrow 
TAB 
Up Arrow 



moves the cursor to the next field of a command form 

moves the cursor right one column 

rolls text up one line at a time, displaying one 
additional line at the bottom of the screen; the 
cursor does not move 

signals the Executive not to store the command in 
the memory buffer used for the Redo feature 

moves the cursor left five columns 

moves the cursor right five columns 

moves the cursor to the next field of a command form 

moves the cursor to the preceding field of a 
command form 
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Table 6 Device Parameters 


Device 


Device Name 




screen 


[VID] 




keyboard 


[KBD] 




printers (nonspooled) 


[PTRJA [PTR]1A 
[PTRJB [PTRJ1B 
[LPT] [PTRJIC 
[PTRJ1D [PTRJ2D 


[PTRJ2A 
[PTRJ2B 
[PTRJ2C 


communications channels 


[COMMJA 
[COMMJB 




spooled printers 


[SPL] [SPL1AJ 
[SPLB] [SPL1BJ 
[SPL1C] [SPL2CJ 
[SPL1D] [SPL2D] 


[SPL2AJ 
[SPL2BJ 


disk drives 


[dO] or [!dO] 

[dl] 

[fOJor[!fO] 

[fU 




null device 


[NUL] 
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Table 7 Date/Time Configuration File Codes 



Day/Month/Year Sequence: 




Code Format 


Example 


MM/DD/YY 

1 DD/MM/YY 

2 YY/MM/DD 


09/16/85 
16/09/85 
85/09/16 


Time Format: 




Code Format 


Example 


AM/PM format 

1 24-hour format 


2:35 PM 
14:35 


Date Format: 




Code Format 


Example 


xxx nn, nnnn 

1 nn/nn/nn 

2 xxx nn, 
nnnn 


Sep 16, 1985 
09/16/85 
Sep 16, 
1985 
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Table 8 Spooler Configuration File Entries 



Component 



Explanation 



Channel 



Printer Name 



Queue Name 



Configuration 
File 



Priority 



Banner (Y/N) 



specifies the channel to which the printer is connected 
= Centronics-type (parallel) port 
A = Channel A (serial) 

B = Channel B (serial) 

specifies the name of the printer connected to the 
channel 

The printer name must be the same as the name 
specified in the Device Configuration file 

specifies the name of the Scheduling queue 
assigned to the printer 

specifies the Printer Device Configuration file 

specifies the priority of the Spooler process for 
the printer 

The entry is a number from 10 to 254; 10 is the 
highest priority. The default is 130. 

Accepting the default or entering a higher number 
insures that the printer does not slow down the 
performance of interactive applications (such as 
the word processing program). 

specifies whether the system prints a banner page 
at the beginning of each document 



The default is no. 
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Table 9 Queue Index File Entries 



Component 



Explanation 



Queue Name 
File Specification 



Entry Size 
Queue Type 



specifies the name you assign to the queue 
specifies the queue's file specification 

You enter Scheduling queue file specifications in 
the following format: 

[Sys]<Spl>xxxxx.queue 

where xxxxx is the appropriate queue name. 

You enter Control queue file specifications in the 
following format: 

[Sys]<Sys>xxxxxSeriaiControl.queue 

for serial printers, and 

[Sys]<Sys>xxxxxParallelControl.queue 

for parallel printers 

where xxxxx is the appropriate printer name. 

You enter the Spooler Status queue specification 
in the following format: 

[Sys]<Sys>SpoolerStatus.queue 

specifies the number of sectors per entry. The 
Spooler requires the entry 1. 

Enter the number 1 to specify a Spooler queue. 
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Table 10 Executive Printing Commands 



Command 



Type of Printing 



Action/Explanation 



APPEND 



direct printing 



COPY 



direct printing or 
spooled printing 



FORMAT 



PRINT 

SPOOLER 
STATUS 



direct printing or 
spooled printing 

spooled printing 
spooled printing 



Refer to APPEND Command. 

This command transfers the contents of a 
file to the printer with no formatting such 
as pagination, margins, etc. 

To print a file, enter the name of the file in 
the File from field and the nonspooled 
device name for the printer attached to your 
workstation, in the File to field. 

Refer to COPY Command. 

This command transfers the contents of a 
file to the printer with no formatting such 
as pagination, margins, etc. 

To print a file, enter the name of the file in 
the File from field and the device name for 
the printer attached to your workstation, in 
the File to field. 

This command allows you to 

set the format of a file's contents and then 

print it. Refer to FORMAT Command. 

Refer to PRINT Command. 

This command allows you to monitor and 
control spooled printing as well as print 
files. Refer to SPOOLER STATUS 
Command in the BTOS Standard 
Software Operations Guide. 
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Table 1 1 Printer Device Names 



Nonspooled 
Device Name 



Spooled 

Device 

Name 



Printer 
Description 



[Lpt] 


[Spl] 


[Ptr]A 




[Ptr]B 


[SplB] 


[Ptr]1A 


[SpHA] 


[Ptr]1B 


[SpllB] 


[Ptr]1C 


[SpHC] 


[Ptr]1D 


[SpUD] 


[Ptr]2A 


[Spl2A] 


[Ptr]2B 


[Spl2B] 


[Ptr]2C 


[Spl2C] 


[Ptr]2D 


[Spl2D] 



Parallel printer interface 

Serial printer (Channel A) 

Serial printer (Channel B) 

Serial printer (Channel A on four-port 
communications expander) 

Serial printer (Channel B on four-port 
communications expander) 

Serial printer (Channel C on four-port 
communications expander) 

Serial printer (Channel D on four-port 
communications expander) 

Serial printer (Channel A on four-port 
communications expander) 

Serial printer (Channel B on four-port 
communications expander) 

Serial printer (Channel C on four-port 
communications expander) 

Serial printer (Channel D on four-port 
communications expander) 



Note: [Ptr]A and [Ptr]0A are synonyms. 
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Table 12 Typical Drive Device Names 

Device Name Drive Description 

dO the first hard disk drive at the master workstation or at a 

workstation with local file storage 

d1 an additional hard disk drive on a workstation 

!d0 the hard disk drive at the master workstation when specified from 

a cluster workstation with local file storage 

fO the first floppy disk drive of a local workstation 

f1 the second floppy disk drive on a workstation with two floppy 

disk drives 

!f0 the first floppy disk drive of the master workstation when 

specified from a cluster workstation with local file storage 
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Table 13 


Parameters of Available Hard Disk Drives 




Type 


Size 


Cylinders 


Heads 


Sectors 


A 


10Mb 


306 


4 


16 


B 


10Mb 


306 


4 


16 


C 


20Mb 


612 


4 


16 


D 


40Mb 


645 


7 


16 


F 


20Mb 


612 


4 


16 


G 


20Mb 


612 


4 


16 


K 


80Mb 


1024 


8 


16 


M 


80Mb 


1024 


8 


16 


N 


40Mb 


699 


7 


16 





80Mb ECC 


830 


10 


16 


P 


40Mb ECC 


989 


5 


16 
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Table 14 Bad Spot Reports and Sample Entries 


Report Type Sample Bad Spot 

Information 


Sample 
Entries 



Media Defect 
Reports 



Cylinder 
11 
30 



Head 

2 



Sector 

4 

12 



11/0/#4 
30/2/#12 



Note: In your entry, place a number sign before the sector number. 



Media Error 
Maps 



Trk Hd Byte Count 



005 4 
084 1 



00107 
002646 



Length 
(bits) 

03 

04 



5/4/107/3 
84/1/2646/4 



Note: In your entry, eliminate leading zeros in all columns. 



Quantum Cylinder Head Error Error 

Q2000 Displace- Length 
Media ment 

Defect 84/54 1 2646/ A56 4/4 

Reports 241/ F1 2 8130/1FC2 39/27 



84/1/2646/4 
241/2/8130/39 



Note: In your entry, use only the first number set in any column. Do not use 
the numbers following the slash marks. 



Test Summaries 



Hard Cyl 
26 
38 



MapHd 
3 
2 



Sec Byte 

1 7 

2 5 



26/3/#1 
38/2/#2 



Note: In your entry, use numbers from columns 1 through 3 only; place a 
number sign before the sector number. 



Media Defect 
Report 



Cylinder 



13S 
294 



Head 



Byte From 
Index (BFI) 

1505 
9061 



Length 
(Bits) 

201 
221 



Tables 2-19 

Table 15 Commonly Used File Suffixes 

File Suffix File Description 

.run Run file 

.sub Submit file 

.sys System file 

.1st List file 

.txt Text file 

.user User signon file 

.config Text Configuration file 

.cnfg Code Configuration file 

.tmp Temporary file 

.jcl Job Control Language 

.form Form file 

.fmt Format file 

.lib Library file 

.map Linker Map file 

.obj Object file 

-old Old file (The system adds this suffix to the 

original file name when you save a file.) 

>save Saved file (similar to an -old file) 

-new New file (The system adds this suffix to a file 

name during a recovery procedure.) 
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Table 16 File Specifications for Listing Files 



File Specification 



Action 



[Voll\lame]<*>* 
[!VolName]<*>' 



<DirName>* 
<*>FileName 

*>Filel\lame 

SubDirName>* 



The system lists all the files in all the directories 
of the specified volume. 

The system iists all the files in all the directories 
on the master workstation's mass storage unit 
when specified on a cluster workstation with local 
file storage. 

The system lists all the files in the current directory. 

The system lists all the files in the specified directory. 

The system lists all the files with the specified 
file name in all directories. 

The system lists all the files with the specified 
file name in all directories and subdirectories. 

The system lists all files in the specified 
subdirectory. 
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Table 17 Protection Levels 


Protection 
Level 


Decimal 
Value 


Password Required 
To Read To Modify 


unprotected 


15 


none 


none 


modify password 


7 


none 


volume, 
directory, or 
file 


access password 


3 


volume, 
directory, 
or file 


volume, 
directory, or 
file 


nondirectory password 


51 


volume or file 


volume or file 


nondirectory modify 
password 


23 


none 


volume or file 


nondirectory access 
password 


19 


volume, 
directory or file 


volume or file 


modify protected 


5 


none 


volume or 
directory 


access protected 





volume or 
directory 


volume or 
directory 


read password 


1 


volume, directory 
or file 


volume or file 
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Table 18 Sample SELECTIVE BACKUP File List Parameters 

File List Field 

Parameter Description of Files Archived 

[ABC]<*>* The system copies all files on volume ABC to an 

archive file. This is similar to the BACKUP 
VOLUME operation with no verification. 

[Win]<Work2>* The system copies all files in the directory Work2 

to an archive file. 

@MyFile The system copies a list of files to an archive file. 

You use the Editor or FILES command to create 
an at-file containing the list of files you want to 
copy. For example, here the at-file MyFile contains 
the list of files. 
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Table 19 Special Command Edit Functions 



Function 



Key 



Procedure 



INSERT F4 To insert a line in the command form: 

1 Position the highlight below the 
insert location. 

2 Press INSERT (F4). 

3 Type the line. 

DELETE F5 To delete a line in the command form: 

1 Position the highlight on the line. 

2 Press DELETE (F5). 
BLANK F6 To insert a blank line: 



Caution: Do not press BLANK (F6) when the 
highlight is over a line you want to retain. If you do, 
the system replaces the existing line with a blank line. 



1 Position the highlight below the 
insert location. 

2 Press INSERT (F4). 

3 Press BLANK (F6). The message 
<blank> appears. 
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Table 20 Executive Intrinsic Commands 


Command Name Run File Field Parameter 



APPEND 


!1 


COPY 


!2 


CREATE DIRECTORY 


!14 


CREATE FILE 


!5 


DELETE 


!3 


LIST 


!8 


LOGIN 


!7 


PATH 


!7 


PLAYBACK 


!21 


RECORD 


!19 


REMOVE DIRECTORY 


!15 


RENAME 


!4 


RUN 


!18 


RUN FILE 


!16 


SCREEN SETUP 


!17 


SET FILE PREFIX 


!9 


SET PROTECTION 


no 


STOP RECORD 


!20 


TYPE 


!6 


VIDEO 


!11 



Tables 2-25 

Table 21 Escape Sequence Components 

Component Function 

% introduces an escape sequence (You can include it in the text by 

typing it twice, %%, in which case, the system ignores it.) 

D expands the current date/time 

[ expands the current volume selection 

< expands the current directory specification 

expands the current password specification 
U expands the current user name specification 

introduces a comment 

introduces a comment 

? introduces a type of conditional expansion 

# introduces a type of conditional expansion 

n represents one of the digits through 9 used to indicate which 

of the parameters in the [Parameters] field in the SUBMIT 
command form replaces the escape sequence 

b is a character that delimits the start and end of conditional 

expansions 

text is a sequence of characters inserted in a conditional expansion, 

including other calls to SUBMIT, other command invocations, 
messages to be output to the screen, etc. 

>n is one of the digits through 9 preceded by another character, 

such as ] 
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Table 21 Escape Sequence Components (continued) 



Component 



Function 



date/time is the template for introducing date/time; the date and time can 

be formatted by using any of the following parameters: 



Key 



Expansion 



h 


hour in 12-hour notation (1-12) 


t 


hour in 24-hour notation (0-23) 


m 


minute (0-59) 


s 


second (0-59) 


a 


AM/PM 


y 


year (1952-2042) 





month number (1-12) 


n 


month name 


d 


day of month (1-31) 


w 


weekday name 


Modifier 


Meaning 





zero-filled 


• 


variable width 
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Table 22 


Hexadecimal Codes for Special Keys 


Key 


Hex Code Display Character 



HELP 


00 


MARK 


02 


FINISH 


04 


PREV PAGE 


05 


CANCEL 


07 


BACKSPACE 


08 


TAB 


09 


RETURN 


0A 


Down Arrow 


OB 


NEXT PAGE 


OC 


BOUND 


OD 


MOVE 


OF 


SCROLL UP 


11 


SCROLL DOWN 


13 


COPY 


14 


F1 


15 


F2 


16 


F3 


17 


F4 


18 


F5 


19 


F6 


1A 


GO 


1B 


F7 


1C 


F8 


1D 


F9 


1E 


F10 


1F 



null 

solid right triangle 

solid square 

hollow square 

bell 

backspace 

tab 

new line 

down arrow 

formfeed 

solid left triangle 

double dagger 

dagger 

trough 

raised dot 

division sign 

vertical bar 

dollar sign 

not equal 

similarly 

paragraph 

solid bullet 

not 

equal to or less than 

plus or minus 

equal to or greater than 
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Index 



APPEND command form, 1-4 
B 

BACKUP VOLUME command form, 1-5 

Bad spot reports and sample entries, 2-18 

BOOTSTRAP command form, 1-8 

BTOS memory and disk space requirements, 2-2 



CHANGE VOLUME NAME command form, 1-9 
Cluster communications lines, 2-6 
CLUSTER STATUS command form, 1-1 1 
Codes 

date/time configuration file, 2-1 1 
Command edit functions (special), 2-23 
COMMAND FILE EDITOR command form, 1-12 
Command form 

APPEND, 1-4 

BACKUP VOLUME, 1-5 

BOOTSTRAP, 1-8 

CHANGE VOLUME NAME, 1-9 

CLUSTER STATUS, 1-11 

COMMAND FILE EDITOR, 1-12 

COPY, 1-13 

CREATE CONFIGURATION FILE, 1-15 

CREATE DIRECTORY, 1-16 

CREATE FILE, 1-18 

CREATE PARTITION, 1-20 

DEBUG FILE, 1-21 

DELETE, 1-22 

DISABLE CLUSTER, 1-23 

DUMP, 1-24 

EDIT, 1-26 

FILES, 1-27 

FLOPPY COPY, 1-28 

FORMAT, 1-30 

INSTALL PROTECTED MODE, 1-34 

INSTALL SPOOLER, 1-35 

INSTALL TELEPHONE SERVER, 1-36 

IVOLUME, 1-37 

LCOPY, 1-43 

LIST, 1-46 

LOGIN, 1-47 

MAINTAIN FILE, 1-49 

MAKE TRANSLATION FILE, 1-51 
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MERGE, 1-52 

NEW COMMAND, 1-54 

PATH, 1-56 

PLAYBACK, 1-58 

PLOG, 1-59 

PRINT, 1-61 

RECORD, 1-64 

REMOVE COMMAND, 1-65 

REMOVE DIRECTORY, 1-66 

RENAME, 1-67 

REPLAY, 1-69 

RESTORE, 1-70 

RUN, 1-73 

RUN FILE, 1-74 

SCREEN SETUP, 1-75 

SELECTIVE BACKUP, 1-77 

SET DIRECTORY PROTECTION. 1-80 

SET FILE PREFIX, 1-81 

SET PROTECTION, 1-82 

SET TIME, 1-83 

SOFTWARE INSTALLATION, 1-84 

SORT, 1-85 

SUBMIT, 1-87 

TYPE, 1-88 

USER FILE EDITOR, 1-89 

VIDEO, 1-91 

VOLUME STATUS, 1-93 

WRITE HARDWARF ID, 1-95 

XESOFTWARE INSTALLATION, 1-96 
Commands 

executive instrinsic, 2-24 

executive printing, 2-14 
Commonly used file suffixes, 2-19 
Communications lines 

cluster, 2-6 
Components 

escape sequence, 2-25 
COPY command form, 1-14 
CREATE CONFIGURATION FILE command form, 1-15 
CREATE DIRECTORY command form, 1-16 
CREATE FILE command form, 1-18 
CREATE PARTITION command form, 1-20 



Date/time configuration file codes, 2-1 1 
DEBUG FILE command form, 1-21 
DELETE command form, 1-22 
Device names 

printer, 2-15 
Device parameters, 2-10 
DISABLE CLUSTER command form, 1-23 
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Disk space and memory requirements (BTOS), 2-2 
Drive device names, typical, 2-16 
DUMP command form, 1-24 



EDIT command form, 1-26 
Editing functions 

keyboard, 2-7 
Entries 

queue index file, 2-13 

spooler configuration file, 2-12 

user file signon, 2-4 
Escape sequence components, 2-25 
Executive 

intrinsic commands, 2-24 

printing commands, 2-14 



FILES command form, 1-17 

File specifications for listing files, 2-20 

File suffixes 

commonly used, 2-19 
FLOPPY COPY command form, 1-28 
FORMAT command form, 1-30 
Functions 

keyboard editing, 2-7 

special command edit, 2-23 

H 

Hard disk drives 

parameters of available, 2-17 
Hexadecimal codes for special keys, 2-27 

I 

INSTALL PROTECTED MODE command form, 1-34 
INSTALL SPOOLER command form, 1-35 
INSTALL TELEPHONE SERVER command form, 1-36 
Intrinsic commands 
executive, 2-24 
IVOLUME command form, 1-37 

K 

Keyboard editing functions, 2-7 
Keys 

hexadecimal codes for special, 2-27 
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LCOPY command form, 1-43 
Levels of protection, 2-21 
LIST command form, 1-46 
Listing files 

file specifications for, 2-20 
LOGIN command form, 1-47 

M 

MAINTAIN FILE command form, 1-49 
MAKE TRANSLATION FILE command form, 1-51 
Memory and disk space requirements (BTOS), 2-2 
MERGE command form, 1-52 

N 

NEW COMMAND command form, 1-54 
P 

Parameters (device), 2-10 
Parameters of available hard disk drives, 2-17 
PATH command form, 1-56 
PLAYBACK command form, 1-58 
PLOG command form, 1-59 
PRINT command form, 1-61 
Printer device names, 2-1 5 
Printing commands 
executive, 2-14 
Protection levels, 2-21 

Q 

Queue index file entries, 2-13 
R 

RECORD command form, 1-64 
REMOVE COMMAND command form, 1-65 
REMOVE DIRECTORY command form, 1-66 
RENAME command form, 1-67 
REPLAY command form, 1-69 
Requirements 

BTOS memory and disk space, 2-2 
RESTORE command form, 1-70 
RUN command form, 1-73 
RUN FILE command form, 1-74 
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Sample SELECTIVE BACKUP file list parameters, 2-22 

SCREEN SETUP command form, 1-75 

SELECTIVE BACKUP command form, 1-77 

SET DIRECTORY PROTECTION command form, 1-80 

SET FILE PREFIX command form, 1-81 

SET PROTECTION command form, 1-82 

SET TIME command form, 1-83 

SignOn entries 

user file, 2-4 
SOFTWARE INSTALLATION command form, 1-84 
SORT command form, 1-85 
Special keys 

hexadecimal codes for, 2-24 
Spooler configuration file entries, 2-12 
SUBMIT command form, 1-87 
Suffixes (fde) 

commonly used, 2-19 



TYPE command form, 1-88 
U 

USER FILE EDITOR command form, 1-89 
User file signon entries, 2-4 

V 

VIDEO command form, 1-91 

VOLUME STATUS command form, 1-93 

W 

WRITE HARDWARE ID command form, 1-95 
X 

XESOFTWARE INSTALLATION command form, 1-96 
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